.. _cemDiMulti_Get:

cemDiMulti_Get
==============
--------------


SYNOPSIS
--------


.. code-block:: none

  VT_I4 cemDiMulti_Get(
    VT_I4 IniChannel,
    VT_I4 NumChannel,
    VT_PI4 InputState
  )



DESCRIPTION
-----------


- 모션 디지털 입력이 지원되는 제품에서 다중 채널에 대해 디지털 입력 상태를 반환합니다. 



PARAMETER
---------


- IniChannel : 시작 채널 번호. 통합 채널로 관리되는 채널 번호를 의미하며, 상수 값으로 0 (Zero. Based) 이상, (최대 통합 채널수 - 1) 이하의 값을 채널 번호로 설정할 수 있습니다. 

- NumChannel : 시작 채널로부터 몇 개의 채널의 상태를 확인할 것인지에 대한 값을 전달합니다. (최대 32 개 채널까지 설정 가능합니다.). 

- InputState : 이 매개변수를 통하여 다중 디지털 입력 채널의 입력 상태를 반환합니다. (32 비트,. BIT0 ~ BIT31). 


+--------------+---------+
| Value        | Meaning |
+==============+=========+
| 0 (CE_FALSE) | OFF     |
+--------------+---------+
| 1 (CE_TRUE)  | ON      |
+--------------+---------+




RETURN VALUE
------------

+----------------+-------------------------------------------------------+
| Value          | Meaning                                               |
+================+=======================================================+
| 음수           | 수행 실패. 자세한 내용은 '에러 처리' 편을 참고합니다. |
+----------------+-------------------------------------------------------+
| 0 (ceERR_NONE) | 수행 성공                                             |
+----------------+-------------------------------------------------------+

EXAMPLE
`````````````

.. code-block:: cpp
 :linenos:

 C/C++
 #include “ceSDK.h”
 #include “ceSDKDef.h”
 /* MDO 0~3 번 채널의 출력을 제어하고,
 MDO 0~3 번 채널의 출력 상태를 MDI 0~3 번 채널을 통해 입력 받아 확인합니다. */
 long nMdiIniChNo = 0; // MDI 시작 채널 번호 설정
 long nMdiChNum = 4; // MDI 채널 개수 설정
 long nMdoIniChNo = 0; // MDO 시작 채널 번호 설정
 long nMdoChNum = 4; // MDO 채널 개수 설정
 long dwMdiStates, dwMdoStates; // MDIO 상태 정보
 // MDO 0~3 번 채널의 출력 상태를 0, 1, 3 ch : ON, 2 ch : OFF 로 설정하고 출력 상태를 확인 합니다.
 if ( cemDoMulti_Put ( nMdoIniChNo, nMdoChNum, 0xB ) == ceERR_NONE )
 {
  cemDoMulti_Get ( nMdoIniChNo, nMdoChNum, &nMdoStates );
   if ( nMdoStates != 0xB )
    {
     OutputDebugString ( “cemDoMulti_Put has been failed” )
    }
 }
 // MDI 0~3 번 채널의 입력 상태를 확인합니다.
 if ( cemDiMulti_Get ( nMdiIniChNo, nMdiChNum, &nMdiStates ) == ceERR_NONE )
  {
   if ( nMdiStates != nMdoStates )
    {
     OutputDebugString ( "cemDiMulti_Get has been failed" );
    }
  }